MoveFirst

Object and Type

Object  : FCGeneric

Type     : Method

Prototype

Public Sub MoveFirst()

Description

This method sets the current record for the generic object to the first object in the recordset. The order of the records is determined by the database query used to build the generic object's recordset, or the order in which AddNew method calls were made.

If there are no records in the generic object, the BOF flag will be set to True.

If this is a child object, it is important to realize that the record that this method will find is dependent on the current row in the parent object. This will find the first record in this generic that is related to the current parent record.

Example

The following example queries for sites in the database. It then uses MoveFirst and MoveNext to iterate through the records.

JavaScript:

The code in this example is written in JavaScript for inclusion in ASP pages.

  // Get sites so we can loop through them

  var boSite = FCSession.CreateGeneric();

  boSite.SimpleQuery("site");

  boSite.Query();

  // This is not needed, as the query does a MoveFirst

  boSite.MoveFirst();

  // Now print them out

  while (boSite.EOF != true)

  {

    Response.Write ("Site: " + boSite("name"));  

    boSite.MoveNext();

  }

Visual Basic:

The code in this example is written in Visual Basic.

  Dim boSite As FCGeneric

  Set boSite = fc_session.CreateGeneric

  boSite.SimpleQuery "site"

  boSite.Query

  boSite.MoveFirst

  While boSite.EOF = False

    MsgBox "Site is: " & boSite("name")

    boSite.MoveNext

  Wend